<h2>Configuration pour "étendre" les templates</h2>

<h3>Objectif</h3>
<p>Définir les conditions de remplacement de chaque template (modèle) à partir de template-extension
(template appelé "replacer" (remplaçant)).</p>

<p>Les "Templates d'origine" provenant de ./template/yoga (ou de tout autre dossier que "yoga")
 sont remplacés par un remplaçant si celui-ci est lié à son template d'origine
 (et de façon facultative, quand l'adresse (URL) demandée contient un URL contains un "Paramètre facultatif de l'URL").</p>

<p>Les "Paramètres facultatif de l'URL" sont ceux que vous pouvez trouver après le nom du module dans l'adresse (URL).</p>

<p>Ainsi un "Paramètre facultatif de l'URL" peut être un "permalink" (lien permanent) actif
(voir les permalinks dans notre documentation pour plus d'information).</p>

<p>Lire les `<a href="#warnings">mises en garde</a>` sur les conditions d'utilisation.</p>

<h3>Qu'est-ce que les extensions des modèles?</h3>

<p>Cet outil de configuration est à la fois puissant pour les débutants et pour les utilisateurs avancés.
Par FTP, dans le dossier template-extension, le Webmaster pourra dupliquer une bonne partie des fichiers
 .tpl distribués ("Templates d'origine") avec un nom différent  
 ("replacer" (remplaçant)).
 
 "Templates d'origine", actuellement les modèles d'origine supportés sont:</p>
<ul>
  <li><span class="filename">index.tpl</span></li>
  <li><span class="filename">mainpage_categories.tpl</span> and/or <span class="filename">thumbnails.tpl</span></li>
  <li><span class="filename">menubar.tpl</span></li>
  <li><span class="filename">header.tpl</span> and/or <span class="filename">footer.tpl</span></li>
  <li><span class="filename">picture_content.tpl</span> and/or <span class="filename">picture.tpl</span></li>
  <!-- <li><span class="filename">slideshow.tpl</span></li> -->
  <li><span class="filename">profile.tpl</span> and/or <span class="filename">profile_content.tpl</span></li>
  <li><span class="filename">tags.tpl</span></li>
  <li><span class="filename">upload.tpl</span></li>
  <li><span class="filename">about.tpl</span></li>
  <li><span class="filename">popuphelp.tpl</span></li>
  <li><span class="filename">search.tpl</span> and/or <span class="filename">search_rules.tpl</span></li>
  <li><span class="filename">nbm.tpl</span> and/or <span class="filename">notification.tpl</span></li>
  <li><span class="filename">identification.tpl</span> and/or <span class="filename">register.tpl</span></li>
  <li><span class="filename">redirect.tpl</span></li>
</ul>

<h3>Où puis-je trouver les "Templates d'origine"?</h3>

<p>Les modèles distribués d'origine sont dans template/yoga/ 
(ne pas les modifier directement à cet endroit pour des raisons d'évolution). Ainsi à partir des "templates d'origine", 
tout webmaster pourra créer ses "replacers (modèles personalisés)".</p>

<h3>Où dois-je enregistrer les "remplaçants"?</h3>

<p>Les <strong>Replacers (templates modifiés)</strong> peuvent être placés dans le dossier 
template-extension (ou ses sous-dossiers).
Les remplaçants peuvent avoir n'importe quel nom de fichier avec l'extension .tpl. Par exemple: <span
class="filename">template-extension/my-extension/video.tpl</span>.</p>


<h3>Comment puis-je activer mes "remplaçants"?</h3>
<p>Un <strong>template d'origine</strong> devrait être associé à chaque
 <strong>replacer (modèle modifié)</strong> à fin d'activer les remplacements correspondants.
 Activer les remplaçants est la fonction de "Etendre les templates" dans les menus de Configuration de l'Administration.</p>

<p>Si vous sélectionnez un <strong>Paramètre facultatif de l'URL</strong> alors les remplacements 
ne seront réalisés que sur les pages utilisant ce mot clé. Par exemple: <span
  class="pwgScreen">index.php?/<strong>most_visited</strong></span></p>
  
<p>Les utilisateurs avancés utiliseront les permalinks (permaliens, liens permanents) en tant que 
<strong>paramètre facultatif de l'URL</strong>. </p>

<p>Si vous sélectionnez un <strong>Template rattaché</strong> alors les remplacements ne seront réalisés que sur ce template.</p>

<h3>Comment puis-je désactiver mes "replacers"?</h3>
<ul>
<li>Déselectionner le "template d'origine".</li>
<li>Par FTP supprimer le "remplaçant".</li>
</ul>
<a name="warnings"></a>
<h3>Mises en garde</h3>
<ul>

  <li>Le <strong>template d'origine</strong> doit être le véritable template "d'origine"
  autrement vous pourriez avoir des résultats imprévisibles!</li>

  <li>Si plusieurs <strong>remplaçants (templates modifiés)</strong> ont le même
  <strong>template d'origine</strong> et le même <strong>paramètre facultatif
  de l'URL</strong> alors seulement le dernier remplaçant sera actif.</li>

  <li>Ne pas sélectionner de <strong>paramètre facultatif de l'URL</strong> 
  activera le template de remplacement à chaque utilisation du template.
  Comme mentionné ci-dessus, l'ordre peut inhiber les remplaçants précédents.</li>

  <li>Sous-dossiers:
  Les sous-dossiers sont ignorés mais ils sont utiles pour modifier l'ordre des remplaçants.<br>
distributed-samples: pour vos tests sont distributés! 
<strong>Ne pas les modifier</strong>, créez les votres!
</li>

  <li>A la suppression d'un remplaçant le <strong>template d'origine</strong> sera 
  immédiatement réactivé.</li>

</ul>
